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One of the outstanding features of the SWTPC 6800 Microprocessor/System 
o™ USG Motorola s Mikbug ©firmware package stored in the MCM6830L7 
ROM. It is thru the software stored in this ROM that the user may use the 
control terminal to initiate various functions such as load programs, execute 
programs, dump programs and print or change the contents of the CPU registers. 
Motorola's Engineering Note 100 describes in detail the operation of the 
Mikbug vJ ROM, however, there are some additional things which should be noted 
before reading this note. 


Also contained within the Mikbug ® ROM is a program called Minibug ®and 
a section called test pattern. The Minibug ®program is an old and less ela¬ 
borate version of what is now called Mikbug ©and it along with the test 
pattern have been disabled from ROM access. The ROM was designed so that 
either Mikbug or Minibug © could be used and since the MIKBUG ©was by far 
superior, it was chosen for our system. Although Engineering Note 100 has 
instructions for the operation of Minibug®, they should not be read in 
order to avoid confusion. 


Another interesting note is that although Mikbug® is used with an MC6810 
128io word Random Access Memory (RAM) for temporary storage, there are at 
least 54 10 RAM locations that are unassigned located from address A04A 16 to 
A07F inclusive which may be used for user program use. There are also 46 iq 
locations from address A014 to A041 inclusive which have been reserved for the 
push-down stack. This means that a 46 iq deep push down stack may be main¬ 
tained in the MC6810 RAM or that if a short stack is used, the lower portion 
of these 46 iq locations may be used for user program space. It is a good 
idea, however, not to use any locations between A037 and A049 inclusive. 

When you start reading about the "Display Contents of MPU Registers 
Function in Engineering Note 100 it should be pointed out that the system 
always assumes the push-down stack is located between address locations A043 
and A049, with the program counter stored in locations A048 and A049. When¬ 
ever you enter a "G" for the Go to User's Program Function" the first thing 
the processor does is execute a "return from interrupt" instruction (RTI) 
which loads the data stored in address locations A043 to A049 into the pro¬ 
cessor's condition code register, accumulators, index register and program 
counter. If you forget to use the "Memory Examine and Change Function" to 
load the program counter locations (A048 and A049) with the starting address 
of your loaded program, or for that matter any of the processor registers which 
must be initialized to some value, your program of course will not run. At 
the completion of the "return from interrupt" instruction (RTI) the processor 
jumps to the starting address of your program. The stack pointer is set to 
A049 which means any interrupt, branch to subroutine, jump to subroutine or 
push instruction in your program will change the data stored at location A049 
and depending upon the instruction, A048, A047, etc.. This means that if you 
abort the program with the RESET button, you will probably have to go back 
and reload pertinent data in locations A043 thru A049 before restarting the 
program using the "Go to User's Program Function" again. If all of this seems 
confusing, reread this paragraph after reading Engineering Note 100 contained 
in this section of the notebook. 

^Another important note is that there are two subroutines within the Mik— 
bug ©package which greatly aid the programmer in his control terminal input/ 
output routines. They are called INEEE, address E1AC, and OUTEEE, address 
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ElDl whose descriptions follow: 


INEEE (ElAC) - The INEEE subroutine should be used to receive incoming 
characters from the control terminal's keyboard via the control interface 
(serial), I/O port 1. The subroutine loops within itself until a character 
is received, at which time it is deposited into the A accumulator in ASCII 
form. Bit 7, the parity bit of the received data is automatically zeroed out 
and is not checked in any way for accuracy before it is loaded into accumula¬ 
tor A. The B accumulator and index register are used in the subroutine, how¬ 
ever the original data in these locations is stored and then restored at the 
completion of the subroutine. 

OUTEEE (ElDl) - The OUTEEE subroutine should be used to transmit charac¬ 
ters out of the control interface (serial), I/O port 1, to the control terminal. 
The ASCII coded character to be transmitted must be loaded into the A accumula¬ 
tor before the subroutine is called. The entire eight bits are transmitted out 
as they are loaded into the accumulator. No partiy bit determinations are made 
by the subroutine. The B accumulator and index register are used in the sub¬ 
routine, however, the original data in these locations is stored and then 
restored at the completion of the subroutine. 

The simplest way to get to these subroutines is to do a jump to.subroutine 
extended (3SR asm ) or (BD-^g) followed by the address of the subroutine. 

Entry back into the Mikbug®control program can be done automatically at 
the end of your program by inserting a,jump to address E0E3 1fi (JMP ) or 
(7Eis) followed by the address,E0E3j^. 

One final note is that the Motorola Engineering Note 100 does not cover 
the software interrupt ‘function, which is a tool for debugging problems. It 
is used as follows: 

SOFTWARE INTERRUPT (BREAKPOINT) FUNCTION - This software interrupt fun¬ 
ction provides you with a method of entering breakpoints into your program. 
Assume that you are debugging your program and wish to verify that your pro¬ 
gram has reached a particular program instruction. You can, by using the SWI 
(software interrupt) instruction, enter a breakpoint at this program instruc¬ 
tion's address. To enter the breakpoint you load the instruction at the 
selected address with a SWI instruction. Now, when the SWTPC 6800 System 
executes this SWI instruction in the user's program, it returns program con¬ 
trol to the MIKBUG© software interrupt routine, prints the contents of the 
MPU registers, and proceeds to the MIKBUG© control program. This software 
interrupt mode (SWI) which displays the contents of the MPU registers does not 
assume the stack is located between address A043 afld A049 like the "Display 
contents of MPU Registers Function" of the MIKBUG © control program. The re¬ 
gister data printout will be accurate no matter where the stack is positioned 
in memory. The following paragraphs discuss entering the breakpoint into and 
removing a breakpoint from a user's program. 

ENTERING A SWI BREAKPOINT — Use the following procedures to enter a soft¬ 
ware interrupt breakpoint into the user's program. It is assumed prior to 
these procedures that the user's program has been loaded into memory, the 
SWTPC 6800 System is performing its MIKBUG®control program, and the last 
character printed by the data terminal is an asterisk. 

a. Enter a M after the asterisk to open a memory location. The terminal 
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will insert a space after the M. 


b. Enter in 4-character hexadecimal the memory address you have selected 
to enter a breakpoint. The terminal will print on the next line this 
memory address and its contents. Record the memory contents. 

c. EriWr a space code and the hexadecimal characters 3F (SWI instruc¬ 
tion) . The SWI instruction is now stored in memory and the terminal 
prints the next address and its contents on the next line. 

d. Enter a space code followed by carriage return control character. 

The SWTPC 6800 System returns to the MIKBUG ® control program and 
the terminal prints an asterisk on the nekt line. 

e. Run tne user's program in accordance with the Go To User's Program 
Function (described in Engineering Note 100). When the SWTPC 6800 
System executes the SWI instruction, it returns program control to 
the MIKBUG®program, prints the contents of the MPU registers, and 
advances to the MIKBUG ®control program. 

REMOVING A SWI BREAKPOINT AND RESTORING THE PROGRAM - Use the following 
procedures to remove a software interrupt breakpoint from the user's program. 

It is assumed at the start of these procedures that SWI instruction has been 
loaded into a known memory location, the SWTPC 6800 System is performing its 
MIKBUG® control program, and the last character printed by the terminal is an 
asterisk. 


a. Enter a M after the asterisk to open a memory location. The terminal 
will insert a space code after the M. 

b. Enter in 4-character hexadecimal code the address whose SWI instruc¬ 
tion is to be removed. The terminal will print on the next line this 
memory and address and 3F (SWI instruction). 

c. Enter a space code and restore the original instruction removed from 
this address previously. The new contents are stored in memory and 
the terminal prints the following memory address and its contents on 
the next line. 

d. Enter a space code followed by a carriage return control character. 
The SWTPC 6800 System returns to the MIKBUG(§) control program and the 
terminal prints an asterisk on the next line. 
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Dual Address Memory Test CDAT 
By John Christensen 

The CDAT memory diagnostic can be used to help locate memory problems 
in a SVTPC 6800 computer system that MEMCON and ROBIT may miss. The pro- 
grai itself resides entirely within the 128 byte MIKBuPW The program 
must be loaded in two parts to avoid interfering with the systems push 

down stack. The contiguous section of memory to be * e8ted * 8 the 

ins the most significant byte of the lower memory address into A002, the 
least significant byte into A003, the most significant byte of the upper 
memory address in A004 and its least significant byte in A005. The low 
address must be le*s than or equal to the upper address. 

The test starts from the low address and writes a 00 into all 
up to the high address. An FF is then written into the first “ 

all other locations are checked to be sure they contain 00. If all are 
^ the FF is Replaced with a 00 and an FF is written in the next memory 
loaation. This pattern continues until all^memory is checked or an error 
is found. If the*computer returns to MIKBU<$, then no errors were found. 

If the program displays a register dump then a problem was discover¬ 
ed on the board. The register dump should look similar to t e o o ng. 

ADDRESS-y ERROR MSG. 

F3 00 FF 0400 A079 A042 

The important parts of the dump are the ADDRESS and the ERROR MSG. areas, 
as denoted above. The error messages are interpreted as follows. 

A077 Error on initial test pattern (can't write 0’s into mem.) 

A078 Error on second test pattern (can t write FF s into mem.) 

A079 Dual address error low 

A07A Dual address error high 

«n<j A»l<; 

that you can compare with ADDRESS in the regis ^ table tnc luded 

memory locations caused the erro . help locate the 

with the memory board instructions can then be used to 

problem by comparing the bit pattern of the locations in error. 

The CDAT program takes some time to run, so run the diagnostic over 
only one complete board at a time. 


MEM. SIZE 
IK 
2K 
3K 
4K 
8K 


APPROX. RUN TIME 
29 sec. 

1 min. 53 sec. 

4 min. 13 sec. 

7 min. 29 sec. 
more than 30 min. 


MIKBU 


<® i 8 a registered trademark of Motorola, Inc. 




NAM CDAT1 

♦MEM DIAGNOSTIC <JOHN 

E0E3 CONTRL 

OPT . 

EQU 

0 

SE0E3 

A002 

ORG 

tA002 

A002 0002 LOTEMP 

RME 

2 

A004 0002 HI TEMP 

RMB 


AO 14 

ORG 

*A014 

AO14 00 INIPAT 

FOB 

0 

AO 15 FF TESPAT 

FCB 

tFF 

AO16 0002 1 XRTMP 

RMB 


AO IS FE A002 START 

LDX 

lotemf 

AO 1B Bo AO 14 

lda a 

INIF'AT 

AO IE A7 00 LOOP 1 • 

ST A A 

0 . x 

AO20 Ai 00 

CMF A 

0 X 

AO22 26 53 

BNE 

ERPNT1 

AO24 BC A004 

CPX 

HI TEMP 

AO27 27 03 

BEG 

L OAF’ AT 

AO 2 v OS 

AO2A 20 F2 

I NX 

BRA 

L.00P1 

A02C FE AO02 LUAPAT 

LDX 

LOTEMP 

A02F F6 AO 15 

LDA E 

TESPAT 

AO 32 E7 00 LOOP4 

ST A B 

0. X 

AO 34 20 14 

BRA 

CHECK 

AC 48 

ORG 

$A048 

AC 48 AO 18 

FDB 

*A018 

A*. 4A E1 00 CHECK 

CMP B 

0, X 

AC 4C 26 2A 

BNE 

ERPNT2 

AC 4E FF AO 16 GHKLGW STX 

IXRTMP 

At 51 BC A002 L00F2 

CP X 

LOTEMP 

A. 54 27 07 

BEG! 

CHCKHI 

A< 56 09 

A- 57 Al 00 

DEX 

CMF A 

0, X 

AO59 26 1E 

BNE 

ERPNT3 

A05B 20 F4 

BRA 

LOOP 2 

A05D FE AO 16 CHCKH.I LDX 

IXRTMP 

A'.'60 BL A0O4 

. CPX 

HI TEMP 

A' >6.2 27 16 ' 

BEQ 

END 

A- .65 OS LOOPS 

A066 Al 00 

I NX. 
CMP A 

0 , X 

A068 26 10 

BNE 

ERPNT4 

A06A BC A004 

CPX 

HI TEMP 

AO6D 26 F6 

BNE 

LOOPS 

A06F FE AO 16 RESTRE LDX 

IXRTMP 

AO 7 2 A 7 00 

STA A 

0 , X 

AO74 08 

AO75 20 BB 

I NX 
BRA 

LOOP 4 


AO 7 7 3F 
AO78 3F 
AO79 3F 
AO7A 3F 
A07B 7E E0E3 


ERF’NT 1 
ERPNT2 
ERPNT3 
ERF’NT 4 
END 


SW I 
3WI 
3WI 
SWI 
..IMP 


CONTRL 


HR 13TEN&EN"$ > 


STARTING ADDRESS 
ENDING ADDRESS 


INITIAL TEST PATTERN 

TEST PATTERN 

IXR TEMPORARY STORAGE 


ERROR ON INITIAL PATTERN 
ERROR ON TEST PATTERN 
DUAL ADDRESS ERROR LOW 
DUAL ADDRESS ERROR HI 


END 
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